Sets an exception handler for a task.

OSStatus MPSetExceptionHandler (
    MPTaskID task, 
    MPQueueID exceptionQ
);

Parameter descriptions

task

The task to associate with the exception handler.

exceptionQ

The message queue to which an exception message will be sent.

function result

A result code.

DISCUSSION

When an exception handler is set and an exception occurs, the task is suspended and a message is sent to the message queue specified by exceptionQ. The message contains the following information:

• The first 32-bits contain the ID of the task in which the exception occurred.
• The second 32-bits contain the type of exception that occurred. See the header file MachineExceptions.h for a listing of exception types.
• The last 32-bits are set to NULL (reserved for future use).

VERSION NOTES

Introduced with Multiprocessing Services 2.0.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)